home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / rzsz9107.zip / RZ.DOC < prev    next >
Text File  |  1991-07-03  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rx, rb, rz - XMODEM, YMODEM, ZMODEM receive file(s)
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrzzzz [-    eeeettttvvvv]
  13.       rrrrbbbb [-    ttttvvvv]
  14.       rrrrxxxx [-    ccccttttvvvv] _f_i_l_e
  15.       ggggzzzz _f_i_l_e ...
  16.       [----][vvvv]rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.       This program uses error correcting protocols to receive
  20.       files    over a dial-in serial port from    a variety of programs
  21.       running under    PC-DOS,    CP/M, Unix, and    other operating
  22.       systems.  It is invoked from a shell prompt manually,    or
  23.       automatically    as a result of an "sz file ..."    command    given
  24.       to the calling program.
  25.  
  26.       Commercial use of this program is subject to licensing
  27.       conditions detailed in the rz.c source code.    "Commercial
  28.       Use" includes    support    of shareware programs not published by
  29.       Omen Technology INC.
  30.  
  31.  
  32.       This program is not designed to be called from _c_u(_1),    or
  33.       other    communications programs.  Unix flavors of Omen
  34.       Technology's Professional-YAM    communications software    are
  35.       available for    dial-out applications.
  36.  
  37.  
  38.       _R_z (Receive ZMODEM) receives one or more files with the
  39.       ZMODEM protocol.  Pathnames are supplied by the sending
  40.       program, and directories are made if necessary (and
  41.       possible).  Normally,    the "rz" command is automatically
  42.       issued by the    calling    ZMODEM program,    but defective ZMODEM
  43.       implementations may require starting _r_z manually.
  44.  
  45.       RRRRbbbb receives file(s) with YMODEM, accepting either standard
  46.       128 byte sectors or 1024 byte    sectors    (YAM sb    ----kkkk option).
  47.       The user should determine when the 1024 byte block length
  48.       actually improves throughput without causing lost data or
  49.       even system crashes.
  50.  
  51.       If True YMODEM (Omen Technology trademark) file information
  52.       (file    length,    etc.) is received, the file length controls
  53.       the number of    bytes written to the output dataset, and the
  54.       modify time and file mode (iff non zero) are set
  55.       accordingly.
  56.  
  57.       If no    True YMODEM file information is    received, slashes in
  58.       the pathname are changed to underscore, and any trailing
  59.       period in the    pathname is eliminated.     This conversion is
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 7/3/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       useful for files received from CP/M systems.
  75.  
  76.       RRRRxxxx receives a    single _f_i_l_e with XMODEM    or XMODEM-1k protocol.
  77.       The user should determine when the 1024 byte block length
  78.       actually improves throughput without causing problems.  The
  79.       user must supply the file name to both sending and receiving
  80.       programs.  Up    to 1023    garbage    characters may be added    to the
  81.       received file.
  82.  
  83.       GGGGzzzz is    a shell    script which calls _s_z to command Pro-YAM or
  84.       ZCOMM    to transmit the    specified files.  Pathnames used with
  85.       _g_z must be escaped if    they have special significance to the
  86.       Unix shell.
  87.       EXAMPLE: gz "-a C:*.c    D:*.h"
  88.  
  89.       RRRRzzzz may be invoked as rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD (with an optional leading -
  90.       as generated by login(1)).  For each received    file, _r_z will
  91.       pipe the file    to ``COMMAND filename''    where filename is the
  92.       name of the transmitted file with the    file contents as
  93.       standard input.
  94.  
  95.       Each file transfer is    acknowledged when COMMAND exits    with 0
  96.       status.  A non zero exit status terminates transfers.
  97.  
  98.       A typical use    for this form is _r_z_r_m_a_i_l which calls rmail(1)
  99.       to post mail to the user specified by    the transmitted    file
  100.       name.     For example, sending the file "caf" from a PC-DOS
  101.       system to _r_z_r_m_a_i_l on a Unix system would result in the
  102.       contents of the DOS file "caf" being mailed to user "caf".
  103.  
  104.       On some Unix systems,    the login directory must contain a
  105.       link to COMMAND as login sets    SHELL=rsh which    disallows
  106.       absolute pathnames.  If invoked with a leading ``v'',    _r_z
  107.       will report progress to /tmp/rzlog.  The following entry
  108.       works    for Unix SYS III/V:
  109.              rzrmail::5:1::/bin:/usr/local/rzrmail
  110.       If the SHELL environment variable includes _r_s_h or _r_k_s_h
  111.       (restricted shell), _r_z will not accept absolute pathnames or
  112.       references to    a parent directory, will not modify an
  113.       existing file, and removes any files received    in error.
  114.  
  115.  
  116.       The meanings of the available    options    are:
  117.  
  118.       cccc    Use 16 bit CRC for XMODEM transfer.  XMODEM file
  119.            transfers default to 8 bit checksum.  YMODEM uses 16
  120.            bit CRC.
  121.       eeee    Force a ZMODEM sender to    escape all control characters;
  122.            normally    only XON, XOFF,    DLE, CR-@-CR, and Ctrl-X are
  123.            escaped.
  124.       tttt ttttiiiimmmm
  125.            Change timeout to _t_i_m tenths of seconds.
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 7/3/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       vvvv    Verbose causes a    list of    file names to be appended to
  141.            /tmp/rzlog .  More v's generate more detailed debugging
  142.            output.
  143.       (Pro-YAM command)
  144.       <_A_L_T-_2>
  145.       Pro-YAM Command: _s_z *._h *._c
  146.       (This    automatically invokes _r_z on the    connected system.)
  147.  
  148.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.       Professional-YAM, ZCOMM, DSZ,    crc(omen), sz(omen),
  150.       usq(omen), undos(omen)
  151.  
  152.       Compile time options required    for various operating systems
  153.       are described    in the source file.
  154.  
  155.      NNNNOOOOTTTTEEEESSSS
  156.       ZMODEM's support of XOFF/XON flow control allows proper
  157.       operation in many environments that do not support XMODEM
  158.       uploads.  Unfortunately, not all timesharing systems support
  159.       input    flow control.  The TTY input buffering on some systems
  160.       may not adequately buffer long blocks    or streaming input at
  161.       high speed.  You should suspect this problem when you    can't
  162.       send data to the Unix    system at high speeds using ZMODEM,
  163.       YMODEM-1k or XMODEM-1k, but YMODEM with 128 byte blocks
  164.       works    properly.
  165.  
  166.       The DSZ or Pro-YAM zzzzmmmmooooddddeeeemmmm llll numeric parameter    may be set to
  167.       a value between 64 and 1024 to limit the burst length
  168.       ("zmodem pl128").  Although this compromises ZMODEM's
  169.       throughput, ZMODEM's superior    reliability remains intact.
  170.  
  171.       If a program that does not properly implement    the specified
  172.       file transfer    protocol causes    _r_z to "hang" the port after a
  173.       failed transfer, either wait for _r_z to time out or keyboard
  174.       a dozen Ctrl-X characters.  Every reported instance of this
  175.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  176.       other    program    with a correct implementation of the specified
  177.       protocol.
  178.  
  179.       Many programs    claiming to support YMODEM only    support    XMODEM
  180.       with 1k blocks, and they often don't get that    quite right.
  181.  
  182.       In the case of a few poorly designed microcomputers, sending
  183.       serial data to a tty port at sustained high speeds has been
  184.       known    to cause lockups, system halts,    kernel panics, and
  185.       occasional antisocial    behaviour.  This problem is not    unique
  186.       to _r_z; CRT terminals with block mode transmission and    line
  187.       noise    have the same effect.  When experimenting with high
  188.       speed    input to a system, consider rebooting the system if
  189.       the file transfers are not successful, especially if the
  190.       personality of the system appears altered.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 7/3/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       The Unix "ulimit" parameter must be set high enough to
  207.       permit large file transfers to Unix.
  208.  
  209.       Telebit modems must not be set to "spoof" UUCP, XMODEM, or
  210.       KERMIT.  Setting one of these    spoofing modes interferes with
  211.       other    protoocls.
  212.  
  213.       32 bit CRC code courtesy Gary    S. Brown.  Directory creation
  214.       code from John Gilmore's PD TAR program.
  215.  
  216.      BBBBUUUUGGGGSSSS
  217.       _R_z is    not intended be    called from _c_u(_1), or other
  218.       communications programs.  Unix flavors of Omen Technology's
  219.       Professional-YAM communications software are available for
  220.       dial-out applications.
  221.  
  222.       _R_z does not support some ZMODEM features.  Unix flavors of
  223.       Professional-YAM may be linked to "rz" to support these
  224.       features.
  225.  
  226.       The ASCII option's CR/LF to NL translation merely deletes
  227.       CR's;    undos(omen) performs a more intelligent    translation.
  228.  
  229.      ZZZZMMMMOOOODDDDEEEEMMMM CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  230.       _R_z supports incoming ZMODEM binary (-b), ASCII (-a),
  231.       newer(-n), newer+longer(-N), protect (-p), Crash Recovery(-
  232.       r), clobber (-y), match+clobber (-Y),    compression(-Z), and
  233.       append (-+) requests.     Other options sent by the sender are
  234.       ignored.  The    default    is protect (-p)    and binary (-b).
  235.  
  236.       Unix Professional-YAM    provides higher    performance and    other
  237.       features not supported by _r_z.    Please contact Omen Technology
  238.       Inc for paritculars.
  239.  
  240.       Omen Technology INC
  241.       Post Office Box 4681
  242.       Portland OR 97208
  243.       503-621-3406
  244.  
  245.  
  246.       The Unix versions support ZMODEM command execution
  247.       (ZCOMMAND).
  248.  
  249.      FFFFIIIILLLLEEEESSSS
  250.       rz.c,    crctab.c, rbsb.c, zm.c,    zmodem.h rz.1
  251.  
  252.       /tmp/rzlog stores debugging output generated with -vv    option
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                          (printed 7/3/91)
  262.  
  263.  
  264.  
  265.